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About this guide 



This guide describes how to install, configure, and troubleshoot the HP StorageWorks Q2300 
PCI-X host bus adapter (Q2300 HBA), part number A7538A, for Itanium™ Linux® operating 
systems. 

For the latest version of this document and other HBA documentation, access the HP storage web 
site http://h18006.www1 ■hp.com/storage/saninfrastructure.html . 

Intended audience 

This guide is intended for system administrators who are experienced with the following: 
Linux operating system 
Host bus adapters (HBAs) 

Related documentation 

In addition to this guide, please refer to the HP StorageWorks Q2300 PCI-X host bus adapter for 
Itanium Linux systems release notes. 

These and other HP documents can be found on the HP web site http:/ / www.docs.hp.com . 
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Document conventions and symbols 



Table 1 Document conventions 



Convention 


Element 


Medium blue text: Figure 1 


Cross-reference links and e-mail addresses 


Medium blue, underlined text 

I httn" / /www hn rnml 


Web site addresses 


Bold font 


• Kp\/ nnmp<i 

I \o y 1 1 \ji 1 1 

• Text typed into a GUI element, such as into a box 

• GUI elements that are clicked or selected, such as menu 
and list items, buttons, and check boxes 


Italics font 


Text emphasis 


Monospace font 


• File and directory names 

• System output 

• Code 

• Tpyt K/npH nt thp rntnmnnn- inp 

I <^/\ I I y > — ' ^ \ji i iii^ ' v/ 1 1 1 1 1 1 \A 1 1 \A 1 1 [ 1 


Monospace, italic font 


• Code variables 

• Command-line variables 


Monospace, bold font 


Emphasis of file and directory names, system output, code, 
and text typed at the command-line 



WARNING! Indicates that failure to follow directions could result in bodily harm or death. 
CAUTION: Indicates that failure to follow directions could result in damage to equipment or data. 



|l'2j^ IMPORTANT: Provides clarifying information or specific instructions. 



r)«jx> NOTE: Provides additional information. 




TIP: Provides helpful hints and shortcuts. 



HP technical support 

Telephone numbers for worldwide technical support are listed on the HP web site: 

http:/ / www.hp.com/ support . 

Collect the following information before calling: 

• Technical support registration number (if applicable) 

• Product serial numbers 

• Product model names and numbers 

• Applicable error messages 

• Operating system type and revision level 

• Detailed, specific questions 

For continuous quality improvement, calls may be recorded or monitored. 

HP strongly recommends that customers sign up online using the Subscriber's choice web site 

http:/ / www.hp.com/ go/e-updates . 

• Subscribing to this service provides you with e-mail updates on the latest product 
enhancements, newest versions of drivers, and firmware documentation updates as well as 
instant access to numerous other product resources. 

• After signing up, you can quickly locate your products by selecting Business support and then 
Storage under Product Category. 

HP-authorized reseller 

For the name of your nearest HP-authorized reseller: 

• In the United States, call 1 -800-345-1 518. 

• Elsewhere, visit http://www.hp.com and click Contact HP to find locations and telephone 
numbers. 

Helpful web sites 

For product information, see the following web sites: 

• http://www.hp.com 

• http:/ / www.hp.com/ go/ storage 

• http:/ / www.hp.com/ support/ 

• http://www.docs.hp.com 
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1 Q2300 HBA features 

This chapter describes the features of the Q2300 HBA (part number A7538A), including: 

• Performance specifications, page 1 0 

• Environmental specifications, page 10 

• Physical specifications, page 1 1 
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Performance specifications 

The Q2300 HBA is a 2-Gb, high-performance Direct Memory Access (DMA) bus master host 
adapter designed for high-end systems. 

This HBA has the following features: 

• Unique, single-integrated Fibre Channel controller for added reliability and optimum 
performance. 

• Autonegotiation of Fibre Channel speed bit rate (1 Gbps or 2 Gbps). 

• Combines a powerful Reduced Instruction Set Computing (RISC) processor, a Fibre Channel 
protocol manager (FPM) with 2-Gb Fibre Channel transceivers, and a peripheral component 
interconnect (PCI) or peripheral component interconnect-extended (PCI-X) local bus interface in 
a single-chip solution. 

• Supports Private Loop Direct Attach (PLDA) and Fabric Loop Attach (FLA) connections. 

• Supports bus master DMA. 

• Supports Fibre Channel protocol-SCSI (FCP-SCSI), IP, and Fibre Channel-Virtual Interface (FC-VI) 
protocols. 

• Supports point-to-point fabric connection (F-PORT FABRIC LOGIN). 

• Complies with: 

• PCI Local Bus Specification revision 2.2. 

• PCI-X Addendum (revision 1 .0) to the PCI Local Bus Specification. 

• Third-generation Fibre Channel-Physical and Signaling Interface (FC-PH-3) standard. 

• Fibre Channel-Arbitrated Loop (FC-AL-2) standard. 

• U.S. and international safety and emissions standards. 

Environmental specifications 



Table 2 lists the HBA environmental specifications. 
Table 2 HBA environmental specifications 



Environment 


Minimum 


Maximum 


Operating temperature 


0°C/32°F 


55°C/131°F 


Storage temperature 


-2°C/-4°F 


70°C/158°F 


Relative humidity (non-condensing) 


10% 


90% 


Storage humidity (non-condensing) 


5% 


95% 
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Physical specifications 

Table 3 lists the HBA specifications. 
Table 3 HBA specifications 



Type 


Specification 


Host bus 


Conforms to PCI Local Bus Specification, Revision 2.2 


Fibre Channel 
specifications 


Bus type: fiber optic media 
Bus transfer rate: 

ZOO Mb/s maximum at halt duplex 
400 Mb/s maximum at full duplex 

Interface chip: ISP2312 


Central processing unit 
(CPU) 


Single-chip design that includes a RISC processor, Fibre Channel 
protocol manager, PCI-XDMA controller, integrated 
serializer/deserializer (SEREDES), and electrical transceivers that 
can auto-negotiate a data rate of 1 Gb/s or 2 Gb/s 


RAM 


256 KB per Fiber Channel controller; scalable to 4 MB 


NVRAM 


256 KB, field programmable 


Flash 


1 28 KB of flash ROM in two 64 KB, software selectable banks, 
field programmable 


Onboard DMA 


Five-channel DMA controller: two data and one command, one 
auto-DMA request, and one auto-DMA response 


Distance 


1 Gbps: 500 meters 50/1 25 |im fiber, 300 meters 62.5/1 25 |*m 
fiber 

2 Gbps: 300 meters 50/1 25 \im fiber, 1 50 meters 62.5/1 25 \im 
fiber 


Cable 


50/1 25jum multimode fiber, 62.5/1 25 jum multimode fiber 


Frame Buffers 


Integrated 10 KB frame buffer FIFOs (6 KB receive and 
4KB transmit) for each data channel 


Connectors 


LC-style connector that supports non-OFC, multimode fiber optic 
cabling using a small form factor optical transceiver module. 


Form factor 


1 7.78 cm x 1 0.67 cm (7.0 in x 4.2 in) 


Power Consumption 
(66MHz PCI-X Optic) 


-4.75 watts 
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2 Installing the HBA 



This chapter describes the procedure for installing the Q2300 HBA, including: 

• Installation prerequisites, page 1 3 

• Installing the HBA, page 16 

Refer to your host documentation for installing the HBA. 

A WARNING! Disconnect the host from the power source before installing the HBA. To reduce the 
risk of personal injury from hot surfaces, allow the internal server or workstation components to cool 
before touching. 



A WARNING! Electrostatic discharge (ESD) can damage electronic components. Be sure you are 
properly grounded before beginning this procedure as described in "Regulatory compliance and 
safety" on page 33 



Installation prerequisites 

Before you begin, make sure you have the following: 

• A screwdriver (Phillips #1 ). 

• An optical multimode cable with an LC-style duplex connector. 

• Each HBA has a unique serial number that is located on the bottom of the adapter. Check the 
HBA and record its serial number, in the unlikely event that the NVRAM is corrupted. 
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HBA components 

Figure 1 shows the Q2300 HBA LEDs that are referenced in this chapter. 
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LED indicators 

Table 4 identifies and describes the activity of the LED indicators. 
Table 4 LED indicators activity 



Green LED 
(2Gb) 


Amber LED 
(1 Gb) 


Comments 


Activity 


Off 


Off 




Power off 


On 


On 




Power on before 
firmware initialization 


1 Flash 


1 Flash 


Both flashing at the 
same time like a heart 
beat 


Power on after firmware 
initialization 


/ F n^hp^ 

£— 1 IUO 1 IVJ 


/ F rKrip^ 


A tprnntp f rKninn Tr)K 

l VI ICI II VJ 1 \* 1 IUO 1 1 1 1 1 U . 1 1 1 1 0 

state changes to not- 
initialized state in 2 to 3 
seconds. Both LEDs are 
On steadily 


Firmwnrp Tin lilt 

1 1 1 1 1 1 VV V~l 1 \* 1 V~l U 1 1 


Off 


On 




1 Gb Link up 


On 


Off 




2 Gb Link up 


Off 


5 Flashes 




Activity at 1 Gb 


5 Flashes 


Off 




Activity at 2 Gb 



Jumpers 

The jumpers on the HBA are set to the default state of the laser and are set at the factory with a 
jumper plug on pins 1 -2 of the J3 jumper and on pins 1 -2 of the J4 jumper. 



A CAUTION: Changing the jumper settings can result in the HBA being inoperable. 
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Before you begin installation 

The HBA is self-configuring. However, some motherboards require manual configuration. See the 
documentation supplied with your computer, or contact your computer dealer to determine if your 
motherboard requires configuration. 

Some motherboards have two kinds of PCI bus slots: master and slave. The Q2300 HBA must be in 
a PCI bus master slot. (Some motherboards have PCI bus master slots that are shared with onboard 
devices. The Q2300 HBA does not work in shared slots.) 

PCI connectors vary among system adapter manufacturers. The Q2300 HBA is a 64-bit PCI device 
that can function in a 32-bit PCI slot; the slot conforms to the PCI specification. The rear edge of the 
PCI slot is notched. 



A CAUTION: If you try to install the adapter in a PCI slot that does not conform to the PCI 
specification, you may damage the device. 

PCI and PCI-X slots look the same. If the server contains both PCI and PCI-X slots, refer to the server 
manufacturer's instructions to determine the slot type. 

The Q2300 HBA is designed and tested to operate at PCI bus speeds of up to 1 33 MHz. 

Installing the HBA 

To install the HBA: 

1. Check the motherboard and make any necessary configuration changes to accommodate the 
HBA. 

2. Power down the peripherals, then turn off the computer. 

3. Remove the computer cover and save the screws. 

4. Choose any PCI bus slot that supports bus mastering. 

5. Most motherboards automatically assign an IRQ level and interrupt line; if your motherboard 
does not, you must assign the IRQ level and use interrupt line A for the selected slot. 

6. Remove the slot cover for the slot in which you will install the HBA. 

7. Place the HBA in the slot. Carefully press the board into the slot until it seats firmly. 

8. Secure the HBA to the chassis following the server manufacturer's instructions. 

9. Connect the appropriate cable from the devices to the corresponding LC-connector. 

10. Carefully reinstall the computer cover. Insert and tighten the computer cover screws. 

1 1 .Power up all external FC devices, then power up the server and observe the monitor to ensure 
proper operation. 
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3 Upgrading the HBA EFI driver and RISC firmware on 
Linux systems 

This chapter describes the procedure for upgrading the Extensible Firmware Interface (EFI) driver 
and RISC firmware for the Q2300 HBA. 
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Upgrading the HBA on Linux systems 

Use the following procedure to upgrade the Q2300 HBA on Linux: 

1. Place the Q2300 HBA in a Linux server with a local boot disk. 

2. Boot to Linux. 

3. Load the fibreutils RPM. 

4. Reboot the server to the EFI shell. 

5. Set the drive to the boot device. For example, fsl : 

6. Change to the directory containing EFIUTIL. For example: 

cd \efi\qla2x00 

7. Enter efiutil.efi to run EFIUTIL. 

8. Enter the adapter command to select the first adapter channel. 

Enter the risc_fw_write command to write the rise firmware. Use the default firmware file. 

10. Enter the ef i_write command to write the EFI driver. Use the default driver file. 

1 1. Repeat step 8 through step 1 0 for other adapter channels. 

12. Choose quit to exit EFIUTIL. 

13. Enter the reset command to reboot. 
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4 Installing the Linux driver 

This chapter provides instructions for installing the Linux qla2x00 drivers for the Q2300 HBA on an 
already installed Red Hat Enterprise Linux (Red Hat EL), kernel 2.4x, or SUSE Linux Enterprise 
Server (SUSE SLES) for 64-bit Itanium system. 

The software kit for this HBA can be obtained from the following HP web site 

http://hl 8006.www1 .hp.com/storage/saninfrastructure.html . 

This section provides instructions for installing the qla2300 driver into a Linux operating system. 

To install the driver, you must be familiar with the operating system under which the HBA is to 
operate, and have access to standard system documentation. 

To install the driver, use the procedures and information in the following sections: 

• Installing the driver kit, page 20 

• Building a driver from the sources, page 21 

• Installing the driver on the boot drive, page 24 

• Loading the driver, page 24 

• System driver parameter max_scsi_luns, page 27 

• Driver command line parameters, page 28 

• Proc file system support, page 28 
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Installing the driver kit 

HP recommends that you install the complete driver kit for this HBA. The kit contains the driver and 
utilities you need to deploy this HBA on Linux. 



Hf NOTE: You must install the gcc compiler and the kernel sources on your system before installing 
the driver kit. 



To install the complete HP driver kit, copy the . gz file to your system and enter the following 
commands: 

# gunzip hp_qla2x00 version_info . tar . gz 

# tar -xvf hp_qla2x0 0 version_info . tar 

# cd hp_qla2x00 

# . / INSTALL 

Refer to the readme file included with the driver kit for more information. 

Using the RPM to install drivers 

The RPM Package Manager (RPM) is a package management system that lets you easily install 
Linux software. Using RPM, you can install software in prebuilt bundles called RPM packages. The 
driver RPM packages have the driver source code and driver utilities. 

Installing the RPM 

To install the RPM, copy the RPM package file to your system and enter the following command: 

# rpm -ivh package_name . rpm 

To manually install the Linux HBA driver RPM, enter the following command: 

# rpm -ivh hp_gla2x00- version_info . rpm 

Upgrading the RPM 

To upgrade the RPM, copy the RPM package file to your system and enter the following command: 

• For Red Hat EL, enter: 

# rpm -Uvh --nopostun — nopreun pa ckage_name. rpm 

• ForSUSESLES: 

# rpm -Uvh package_name . rpm 

Uninstalling the RPM 

To uninstall the RPM package, enter the following command: 

# rpm -e package_name . rpm 
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Installing the fibreutils RPM 

HP recommends installing the fibreutils RPM found in the driver kit. It contains useful utilities for 
managing fibre-attached storage. To manually install this RPM, enter the following command: 

# rpm -ivh fibreuti Is -version. rpm 
For more information about fibreutils, refer to the file /opt/hp/hp_f ibreutils/README. 

Changing driver parameters 

To change driver parameters: 

1. Run the set_parm script located in the /opt/hp/src... directory. 

2. Reboot the server. 

Hf NOTE: You must reboot. Otherwise, you may not be able to unload the qla2200 and/or qla2300 
drivers if there is a process or file system using a device that is attached to the Q2300 HBA. 



Building a driver from the sources 



^ IMPORTANT: The following instructions are for reference only. Use these instructions only if the 
driver was not installed from the driver kit or from the HP driver RPM. 



To build a single-processor version of the qla2300 driver, see the section "Building a uniprocessor 
version of the driver" on page 22. To build a symmetric multiprocessor (SMP) version of the 
qla2300 driver, see the section "Building a multiprocessor version of the driver" on page 22. 



|?f NOTE: You need the gcc compiler installed on your system. If it is not installed, install it now. 
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Building a uniprocessor version of the driver 

Perform the following steps to build a uniprocessor version of the qla2300 driver: 

1. If not already installed, load the kernel-header and kernel-source RPM files from your Linux 
CD-ROM. For example: 

# cd /mnt/cdrom/RedHat/RPMS 

# rpm -iv kernel-headers* . rpm 

# rpm -iv kernel-source* . rpm 

2. Locate the driver source files: 

# If you installed the driver kit or the driver RPM, the driver source files reside at /opt/hp/... 

# If you copied your drivers from other media, copy the qla2x00src-xx . xx . tgz file to the 
/home/qla2x00 directory. For example, if you copied the driver source file to a CD-ROM, 
enter: 

# cd /home 

# mkdir qla2x00 

# cd /home/qla2x00 

# cp /mnt/cdrom/qla* . (The period [.] at the end is required.) 

# tar -xvzf qla* . tgz 

3. Build the qla2300 driver from the sources: 

# For Red Hat EL, enter: 

# make 

# For SUSE SLES, enter: 

# make OSVER=linux 

Building a multiprocessor version of the driver 

Perform the following steps to build an SMP version of the qla2300 driver: 

1. If not already installed, extract the kernel-header and kernel-source RPM files from your Linux 
CD-ROM distribution. For example: 

# cd /mnt/cdrom/RedHat/RPMS 

# rpm -iv kernel -headers *. rpm 

# rpm -iv kernel-source* . rpm 

2. Change to the Linux source directory. 

# For Red Hat EL, enter: 

# cd /usr/src/linux-2 . 4 

# For SUSE SLES, enter: 

# cd /usr/src/linux 

3. At the command prompt, enter the following: 

# make menuconfig 

a. Select Processor type and features, and then press Enter. 
The Processor Type and Features menu appears. 

b. Select Symmetric Multiprocessor, and then press Spacebar. 

c. Click Exit. 
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The system prompts: 

Do you wish to save your new kernel configuration? 

d. Click Yes. 

The system saves a new config file in the current directory. 

4. At the command prompt, enter the following: 

• make dep 

5. Locate the source files: 

• If you installed the driver RPM, the driver source files reside in /opt/hp/... 

• If you copied your drivers from other media, copy the qla2x00src-vx .xx . tgz file to 
the home/qla2x00 directory. For example, if you copied the driver source file on to a 
CD-ROM, enter: 

# cd /home 

# mkdir qla2x00 

# cd /home/qla2x00 

# cp /mnt/cdrom/qla* . (The period [.] at the end is required.) 

# tar -xvzf qla*.tgz 

6. Build the qla2300 driver from the sources: 

• For Red Hat EL, enter: 

# make SMP=1 

• For SUSE SLES, enter: 

# make SMP=1 OSVER=linux 
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Installing the driver on the boot drive 



Hf NOTE: The following instructions for manually installing the driver and loading and unloading the 
driver are required only if the driver has been manually built from source. If the driver was installed 
from an HP driver RPM or driver kit, the driver loads at boot time. 

Before manually installing the driver, note the following: 

• The Q2300 HBA must be installed in the system before installing the qla2300 driver. 

• The kernel_release_version is the Linux kernel release version of your system. 
In the following examples, the path to your driver may be: 

/lib /modules/ kernel_release_versi on /kernel / drivers /addon/... 
Perform the following steps to install the qla2300 driver on the boot drive: 

1. Build the driver binary file. 

To build a driver binary from source files, see the section "Building a driver from the sources" 
on page 21 . 

2. Copy the qla23 00 . o binary file to the following directory: 

/lib /modules/ kernel_release_ version /kernel /driver s/sc si 

3. At the command prompt, enter the following command to update the module dependency: 

# depmod -a 

The qla2300 driver is now installed. However, the driver must be loaded before the system can 
access the devices attached to the HBA. 

Loading the driver 

The qla2300 driver must be loaded before the system can access the devices attached to the 
Q2300 HBA. 

• To build a ramdisk image to automatically load the qla2300 driver at boot time, see "Building a 
ramdisk image to load the qla2300 driver" on page 25. 

• To load the qla2300 driver manually, see "Loading and unloading the qla2300 driver 
manually" on page 26. 
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ilding a ramdisk image to load the qla2300 driver 

You can load the qla2300 driver at boot time using a ramdisk image as shown in this Red Hat EL 
example. 

1. For Red Hat EL, add the following line to the file /etc/modules . conf: 
alias scsi_hostadapter qla2300 

[§f NOTE: If there are other SCSI host adapter boards installed on your system and the 

scsi_hostadapter alias is used, define a different alias (for example, scsi_hostadapter n. The n 
is a number in the range 1 to 9). 

2. Build a new ramdisk image that contains the qla2 3 0 0 . o object file. 

You must copy the driver binary file qla23 00 .o to 

/lib /modules/ kernel_release_version/ drivers / scsi . 

|3f NOTE: The kernel_release_version is the Linux kernel release version of your system. 

3. Add the dependency for the qla2300 driver and build the ramdisk image: 

You can either run depmod -a or make sure the following line is in the 

/ lib/modules/ kernel_release_version/modules . dep file: 

/ lib/modules / kernel_release_versi on/ kernel/ drivers /scsi/ 
qla2300 . o : /lib/modules/Jcerne2_release_version/kernel/ 
drivers/ scsi /scsi_mod. o 
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4. Build the ramdisk image file: 

• For a single-processor system, enter the following command, replacing x.x.xx-x.x with 
your Linux version number: 

/sbin/mkinitrd /boot/newinitrd-image x.x.xx-x.x 

• For a multiprocessor system, enter the following command, replacing x.x.xx-x.x with 
your Linux version number. 

/sbin/mkinitrd /boot/newinitrd-image x. x. xx-x. xsmp 

5. Configure the boot loader with the new ramdisk image: 

a. Modify the elilo . conf file to load the new ramdisk image by changing the following 
line: 

initrd=/boot/initrd_f ile_name 
For example: 
initrd= /boot/newinitrd-image 

b. Reboot the system. 

c. Select the kernel with the new ramdisk image. 

Loading and unloading the qla2300 driver manually 

Before loading the driver manually, first build the driver from sources as described in "Building a 
uniprocessor version of the driver" on page 22 or in "Building a multiprocessor version of the 
driver" on page 22. 

After manually loading the qla2300 driver, you can access the devices and unload the driver 
manually without rebooting the system. The driver is also unloaded each time the system is 
rebooted. 

To load the qla2300 driver: 

1. Manually install the driver binary: 

a. Copy qla2300 . o to the following directory: 

/ 1 ib/modul es / kernel_release_versi on I kerne 1 /drivers /scsi 

b. Update the dependency file. 

Either run depmod -a or make sure that the following line is in the file 

/lib/modules/ kernel_release_ version/modules . dep: 
/lib/modules/.7cerneI_release_versi on/kernel /drivers /scsi/ 

qla2300 . o : /lib/modules/.fcerne2_re2ease_versio.n/kernel/drivers/scsi/scsi_m 
od. o 
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c. Load the driver: 

# modprobe qla23 00 



[If NOTE: HP recommends loading the driver using the modprobe command so that any driver 
parameter value specified in the /etc /modules . conf file takes effect. 



Alternatively, you can load the driver by entering the following command in the directory that 
contains the qla2300 . o file: 

# insmod qla2 3 00.o 

d. If your system has a previous version of the qla driver, rename the old binary included in the 
original distribution to ensure that it does not interfere with the updated version as follows: 

# cd / lib/modules / kernel_release_version/'kemel I 
drivers / addon/qla2 3 0 0 

# mv qla2300.o qla2300_rh.o 

e. After renaming the older driver version, load the new driver using modprobe after updating 
the dependency file. 

2. To manually unload the qla2x00 driver, enter the following command as shown in the following 
example: 

# modprobe -r qla2300 

Additional driver information 
System driver parameter max_scsi_luns 

You can configure support for multiple LUNs in one of three ways. Currently, the maximum number 
of LUNs that can be scanned for each device is 1 28. 



(2%> NOTE: If you have multiple HBAs, set max_scsi_luns to the largest number of LUNs supported by 
\zzJ any one of these HBAs. 



• To configure multiple LUN support during boot time, enter the following command at the boot 
prompt: 

boot: linux max_scsi_luns=128 

• If the SCSI Mid-Layer is compiled as a module, add the following line to the 
/etc/modules . conf file to scan for multiple LUNs at each boot: 
options scsi_mod max_scsi_luns=12 8 

• If the SCSI Mid-Layer is not compiled as a module, you can configure the boot loader to scan 
for multiple LUNs each time the system boots. 

• To complete the configuration, perform the following steps: 

1 . Add the following line to each of the kernel images listed in the elilo . conf file: 

append= " max_s c s i_luns = 12 8" 

2. Reboot the system. 
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Driver command line parameters 

The following command line options are available: 

• Verbose— This option provides detailed debug information. For example: 

# insmod qla2 3 00.o options=verbose 
Waiting for LIP to complete. . . . 

scsi%d: Topology - %s, Host Loop address Ox%x 
scsi(%d): LIP occurred 
scsi(%d): LIP reset occurred 

• Quiet— This option keeps the driver from displaying. For example: 

# insmod qla2300.o ql2xopts=quiet 

Proc file system support 

The /proc file system for the qla2300 driver can be found in the /proc/scsi/qla23 00/ 
directory. This directory contains entries for each SCSI HBA channel in the system. Each entry 
presents information about the adapter and transfer statistics for each discovered LUN. 
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A Configuring the HBA 



This appendix describes how to configure the Q2300 HBA on Linux systems using the 
Configuration protocol Driver Configuration menu. 



If NOTE: This process is for advanced users who want to customize the configuration of the Q2300 
HBA and the connected devices. 



This appendix includes: 

• Starting the Configuration protocol, page 29 

• Using the Driver Configuration menu, page 29 

Starting the Configuration protocol 

To configure the HBA on Linux, access the Configuration protocol as follows: 

1. Use the fibreutils RPM package to obtain efiutil (efiutil . efi) and the auxiliary driver, 
ef iaux.drv as described in "Installing the fibreutils RPM" on page 21 . 

2. Power-on the server to the EFI shell. 

3. Start efiutil as follows (ef iaux.drv is automatically loaded if it is needed): 

a. Set the drive to the boot device (for example, f si :). 

b. Change to the directory containing efiutil. For example, enter: 

cd efi\qla2300 

c. Run efiutil: 

efiutil .efi 

Enter help at any time for information about commands. 

d. Select the HBA channel that you want to configure by selecting adapter. 

e. Select configure. 

4. Configure the HBA's NVRAM by selecting the menu items for the parameters to be changed as 
described in "Using the Driver Configuration menu" on page 29 

5. Write the new configuration to NVRAM. 

6. Exit the utility (select quit). 

7. Reboot the system. 

Using the Driver Configuration menu 

This section describes the Configuration protocol's Driver Configuration menu. The menu contains 
the following sections and functions: 

• NVRAM— Modify settings that are stored in the HBA's NVRAM. 

• Information— View device, HBA, and Help information. 

• Operation— Write or discard NVRAM data and exit the Configuration protocol. 
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The following example shows the Driver Configuration menu. 

Main Menu 

NVRAM Parameters 

1. Edit Adapter Settings 

2. Edit Advanced Settings 
3 . Edit Database 

4. Edit Boot Settings 
Information 

5 . Show Database 

6 . Show Translation 

7. Show NVRAM Buffer 

8. Info 

9. Help 
Operation 

1 0 . Abandon 

11. Write 

12. Quit 
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Table 5 describes the Driver Configuration components. 
Table 5 Driver Configuration menu components 



Menu Option 


Description 


NVRAM Parameters 


1 . Edit Adapter Settings 


Displays the Edit Adapter Settings menu. 


2. Edit Advanced Settings 


Displays the Edit Advanced Settings menu. 


3. Edit Database 


Displays the Edit Database screen. 


4. Edit Boot Settings 


Displays the Edit Boot Settings menu. 


Information 




5. Show Database 


Displays the contents of the WWN database in table form. 


6. Show Translation 


Displays the SCSI target id translation table. This table is a list of SCSI 
tid and fibre channel loop id mapping pairs. Each entry in the table 
consists of the following for each device: 

« SCSI id (tid) 

• Fibre channel loop id (lid) 

• World wide port name (WWPN) 

• World wide node name (WWNN) 

All numbers are in hexadecimal. Tid values from 0x00 to OxOA are 
persistent, and tid values greater than OxOA are assigned 
sequentially as devices are discovered. Tid values greater than 0x80 
are fabric-attached while those below 0x7F are 
arbitrated-loop-attached. 


7. Show NVRAM Buffer 


Displays the contents of the local NVRAM buffer in hexadecimal. This 
is the local buffer containing changes made prior to using the Write 

1 1* i i il i i n a / k i \ /r\ a L i 

selection to commit them to the HBAs NVRAM. 


o. Into 


Displays the following HBA information: 

EFI device path 
■ Port WWPN 

• Serial number 

• SSVID and SSDID from NVRAM 

Use the device path to determine which HBA configuration is displayed. 


9. Help 


Displays a brief description of the menu selections. 



Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 31 



Table 5 Driver Configuration menu components (continued) 



Menu Option 


Description 


Information 


1 0. Abandon 


Abandons the changes in the current Configuration protocol local 
buffer and reloads its contents from the HBA's NVRAM. 


1 1 . Write 


Writes the current Configuration protocol local buffer to the HBA's 
NVRAM. Use this function any time you use a menu selection to modify 
configuration data. When the NVRAM has been successfully written, 
the Configuration protocol local buffer is reloaded from the HBA's 
NVRAM. 


12. Quit 


Quits the Configuration protocol and returns to the EFI shell. You 
must use the Write selection to write any changes to the HBA's 
NVRAM before quitting. 
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B Regulatory compliance and safety 



Laser device 

All HP systems equipped with a laser device comply with safety standards, including International 
Electrotechnical Commission (IEC) 825. With specific regard to the laser, the equipment complies 
with laser product performance standards set by government agencies as a Class 1 laser product. 
The product does not emit hazardous light. 

Laser safety warning 



A WARNING! To reduce the risk of exposure to hazardous radiation: 

• Do not try to open the laser device enclosure. There are no user-serviceable components inside. 

• Do not operate controls, make adjustments, or perform procedures to the laser device other 
than those specified herein. 

• Allow only HP authorized service technicians to repair the laser device. 



Certification and classification information 

This product contains a laser internal to the fiber optic (FO) transceiver for connection to the Fibre 
Channel communications port. 

In the USA, the FO transceiver is certified as a Class 1 laser product conforming to the 
requirements contained in the Department of Health and Human Services (DHHS) regulation 21 
CFR, Subchapter J. A label on the plastic FO transceiver housing indicates the certification. 

Outside the USA, the FO transceiver is certified as a Class 1 laser product conforming to the 
requirements contained in IEC 825-1 : 1 993 and EN 60825-1 :1994, including Amendment 
1 1 : 1 996 and Amendment 2:2001 . 

Laser product label 

The optional label in Figure 2 or equivalent may be located on the surface of the HP-supplied laser 
device. 



This optional label indicates that the product is classified as a 
CLASS 1 LASER PRODUCT. This label may appear on the laser 
device installed in your product. 



Figure 2 Class 1 laser product label 
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International notices and statements 
Canadian notice (avis Canadien) 
Class A equipment 

This Class A digital apparatus meets all requirements of the Canadian Interference-Causing 
Equipment Regulations. 

Cet appareil numerique de la classe A respecte toutes les exigences du Reglement sur le materiel 
brouilleur du Canada. 

European Union notice 

Products bearing the CE marking comply with the EMC Directive (89/336/EEC) and the Low 
Voltage Directive (73/23/EEC) issued by the Commission of the European Community and if this 
product has telecommunication functionality, the R&TTE Directive (1999/5/EC). 

Compliance with these directives implies conformity to the following European Norms (in 
parentheses are the equivalent international standards and regulations): 

• EN55022 (CISPR 22) ■ Electromagnetic Interference 

• EN55024 (IEC6 1000-4-2, IEC6 1000-4-3, IEC6 1000-4- 4, IEC61 000-4-5, IEC6 1000-4-6, 
IEC6 1000-4-8, IEC6 1000-4-1 1) - Electromagnetic Immunity 
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• Power Quality: 

• EN61 000-3-2 (IEC61 000-3-2) - Power Line Harmonics 

• EN61 000-3-3 (IEC6 1000-3-3) - Power Line Flicker 

• EN60950 (IEC60950) - Product Safety 

• Also approved under UL 60950/CSA C22.2 No. 60950-00, Safety of Information Techno 
Equipment. 

BSMI notice 



Japanese notice 



^©sttt, ttfKMaise^mMwg^ssiJM^ (vcci) «s$ 

KM tft m < ( - ft o T IE L V ^ t» & V L T T 5 V \ 

^©s«n, mn^mmmmn,mtm^±mmw,m^ (vcci) 
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Korean notices 



0| 7|7|^ ?§o^ *U^*lir#^* ^ 7|7|0|oq 



7|7| (7 r §g gfi#£]7|7|) 



0| 7|7|^ 7|-3§°£. £j*N-£!t!-#^# & 7|7|^Aj 



Safety 

Electrostatic discharge 

To prevent damage to the system, be aware of the precautions you need to follow when setting up 
the system or handling parts. A discharge of static electricity from a finger or other conductor may 
damage system boards or other static-sensitive devices. This type of damage may reduce the life 
expectancy of the device. 

Preventing electrostatic damage 

To prevent electrostatic damage, observe the following precautions: 

• Avoid hand contact by transporting and storing products in static-safe containers. 

• Keep electrostatic-sensitive parts in their containers until they arrive at static-free workstations. 

• Place parts on a grounded surface before removing them from their containers. 

• Avoid touching pins, leads, or circuitry. 

• Always be properly grounded when touching a static-sensitive component or assembly (see 
"Grounding methods" on page 37). 
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Grounding methods 

There are several methods for grounding. Use one or more of the following methods when 
handling or installing electrostatiosensitive parts: 

• Use a wrist strap connected by a ground cord to a grounded workstation or computer chassis. 
Wrist straps are flexible straps with a minimum of 1 megohm (±10 percent) resistance in the 
ground cords. To provide proper ground, wear the strap snug against the skin. 

• Use heel straps, toe straps, or boot straps at standing workstations. Wear the straps on both 
feet when standing on conductive floors or dissipating floor mats. 

• Use conductive field service tools. 

• Use a portable field service kit with a folding static-dissipating work mat. 

If you do not have any of the suggested equipment for proper grounding, have an HP authorized 
reseller install the part. 



Hf NOTE: For more information on static electricity, or assistance with product installation, contact 
your HP authorized reseller. 
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